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Check off all your kit, 
set up your Raspberry 
Pi, and install the 
software for fun! 
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Test your brains with 
our Pi Wordsearch, 
Spot the Differences. 
Maze and more! 


Begin with Scratch 
and move on to Python 
with our fun Pi coding 
projects! 


Getting Started 

We help you set up your Raspberry Pi 
and install the software you will need 


Scratch: Learn the Basics 

Use Scratch's drag-and-drop coding 
interface to bring your Pi to life 


Scratch: Physical Computing 

Taking Scratch to the next level, we 
show you how to work with pins 


Scratch: The Santa Detector 
Set up a trap to catch old St Nick on 
Christmas Eve, with help from Pi 


Coding with Minecraft 

Your Raspberry Pi can be used to 
code direct to the game - great fun 


Babbage versus Bugs 

Code our exciting Space Invaders clone 
written in Python with Pygame Zero. 

Pi Personality Test 

Test your thoughts on Raspberry Pi 
and find out what type you are! 


Comic Capers 

The Pioneers of Pi come together to 
save the kids from Doctor Bluescreen 


i JTTfhr* 


Python: WhooPi Cushion 

We show you how to make and code a 
farting cushion with your Pi! 


Python: Turtley Amazing 

First steps into Python coding with 
the ever-popular Turtle commands 




























We're going to exp 

detail, but here are 

nieces of tech you 


• Raspberry Pi 

• Monitor or TV 

• HDMI cable 

• USB keyboard 

• USB mouse 

• Power supply 

i ^ microSD card 


.OOQ1 
1000 ' 
1000 
5000 


Bring * 11 




In this beginners' feature we will 
show you... 

How to select the right equipment for 
your Pi adventure 

• How to connect everything together 
correctly before you start 

• How to download and set up the 
software you will need 
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The Raspberry Pi 3 is the third version 
of Raspberry Pi. It replaced the 
Raspberry Pi 2 Model B in February 
2016. New features include... 

• A 1.2GHz 64-bit quad-core 
ARMv8 CPU 

• 802.1 In Wireless LAN 

• Bluetooth 4.1 

• Bluetooth Low Energy (BLE) 

Like the Pi 2, it also has... 

• 4 USB ports 

• 40 GPIO pins 

• Full HDMI port 

• Ethernet port 

• Combined 3.5 mm audio jack 
and composite video 

• Camera interface (CSI) 

• Display interface (DSI) 

• microSD card slot (now push-pull 
rather than push-push) 

• VideoCore IV 3D graphics core 

The Raspberry Pi 3 looks the same as 
the previous Pi 2 (and Pi 1 Model B+) 
and has complete compatibility with 
Raspberry Pi 1 and 2. 


>> 
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A monitor or TV with HDMI in 
can be used as a display with 
a Raspberry Pi. This is the 
quickest and easiest way to see 
what your Pi is thinking. How big 
a screen you want is up to you! 


9 O0S 

Programming 

Office 

^ Games 

Accessones 

^Help 

Preferences 
<$ Run.. 




|lpi@raspberrypi. 


> £7) claws Mail 

> X Raspberry Pi Resources 

>□ The MagPi 

| Q VNC Address Book 

’ VS VNC Viewer 
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Feature 


HDHItoHDHlCable 


y P o'u 0 great 0 qu a 'ity P^ 



7>j2S^S 


Si 


USB Mouse 


A USB mouse is used to move 
the cursor or mouse pointer 
around the screen. It's called a 

Z?,nl aS L ,00ks ,ike * ha s a 
tail. Like the keyboard, it will be 

automatically recognised by the 

Pi when plugged in. Y 


S* usB Keyboard 


SSSS 

recognised when it starts up. 




* Power Supply 


‘*“» KTSS'SSSSiSt .p.w« 

ssaidw ii** 

the official Raspberry Pi power supp V> * You do need t0 check that 
your^oweTsupply provides the right voltage and current (5 V /1.2-2.5 A). 
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Getting Started 


microSD Card 



vZpi'^r 0 inSta u a " °P eratin g system on to 
your Pi so it knows what to do. The latest version of 

foTthe Rasnh 0p ® ratin 9 s y s,em recommended 

card Not aU sn?^’ "““V" 8GB (or bi 99 er ) "licroSD 
card. Not all SD cards are the same, and some can fail 

the^ an ,° D * h " S - ,f yOU ’ re unsure - you can always buy 
the official Pi SD cards. Any 8GB SD card will work * 


Plugging in yourRaspberryPi 


9 Next plug your keyboard and mouse into t P 

selected the right input e.g. HDMI1, HDMI2 etc)^ ^ TV 

5! Jf'yoiTintend to connect your Raspberry Pi to the internet plug an 

6 - s !•£ »»'»■ ™* ° n 

and boot your Raspberry Pi. 
























options to do this... 

• connecting via Ethernet , ide the usb 

• Connecting via WiFi ta wireless lan. if 

If you have a Raspberry Pi 3, it Rasp berry Pi, then you 
you're using an when used 

will need a USB W i s i mp | e plug-and-play devices. 


7^1 
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What's the point in your Raspberry Pi making lots of 
great noises if you can't hear them? 

• 3.5 mm audio port 

The Raspberry Pi comes with a 3.5 mm audio port. This will allow you to plug 
most speakers or headphones into the Pi so that you can listen to the output from 
fantastic programs like Sonic Pi. 

• Bluetooth speakers 

With either the Raspberry Pi 3 or a Bluetooth dongle, you can connect to Bluetooth 
speakers or headphones. Your success rate may vary depending on the dongle 
and/or speakers you re using, so ensure that you read the manufacturer's 
documentation before you buy. 






Getting Started 


' 


You might find that the 8GB SD card you're usino 

needs°Th Raspberry pi isn't big enough for your 

. ' here are several options for increasing the 

storage capacity of your Raspberry Pi... 9 

• A bigger SD card 

microSD cards come in a variety of sizes. The largest 
(reasonably priced) microSD cards are 128GB which 
will provide you with lots of storage. As always check 
the manufacturer's documentation to ensure^hat the 
card is compatible with a Raspberry Pi. 

• USB flash drives 

There are lots of different types of storage device 
which you can plug directly into your Raspberrv Pi's 

s U t S v L port !' USB flash drives “me in a variety 0 f 
you need that much^ ^ ^ UP *° ,TB ° f Space if 

• External hard drives 

You can also purchase external hard drives 
which can be connected via a USB cable. 

You have to be a little careful here. Some 
external hard drives are independently 

Sr°l e Ih d - and wiH WOrk without P r °klems. Some 
draw their power via the USB port, and might need 

more current that the Raspberry Pi can supply Read 

the manufacturer's documentation to ensure any hard drive 

you re usingI will work with the Raspberry Pi. Some external 

R rd ?" ves have been designed specifically to work with the 
Raspberry Pi, such as the WD PiDrive 314GB. 
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Feature 



Data Partition 

Adds an empty 512MB ext4 


format partition to the partition layout. 


Disk space 
Needed 3662 MB 


Available 6508 MB 


Keyboard (9): gb 


Language (1): vAi English (UK) 


ibian (RECOMMENDED) 
immunity-created port of Debian |e»e. 


optimised for lh< 


Installing Ras pbian on your SD Card 
with NOOBS 


So you've just got hold of your first 
Raspberry Pi and you need to get the 
software up and running? Let's show you 
how to install Raspbian on your Raspberry Pi 
in no time at all... 

• Downloading NOOBS 

Using NOOBS is the easiest way to install 
Raspbian on your SD card. To get hold of a 
copy of NOOBS... 


o aprowd. 


1. Visit www.raspberrypi.org and click on the 
Downloads button in the navigation bar, at the top of the screen. 

2. You should see a box which contains a link to the NOOBS files. Click on the link, 
o. The simplest option is to download the zip archive of the files. 

• Writing NOOBS to an SD Card 

Visit etcher.io and download and install the Etcher SD card image utility. 

Run Etcher and select the Raspbian zip file you downloaded. Select the SD card 
drive - Etcher will usually do this for you. Finally, click Burn to transfer NOOBS to 
the SD card. Once complete, the utility will eject/unmount the SD card so it's safe 
to remove it from the computer. 

• Booting from NOOBS 

1. Once the files have been copied 
over, insert the microSD card into 
your Raspberry Pi and then plug it 
into a power source. 

2. You will be provided with a single 
option, once the installer has 
loaded. You should check the box for 
Raspbian, and then click Install. 

3. Click Yes at the warning dialog, and 
then sit back and relax. It will take a 
while, but Raspbian will install. 
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HEE-HEE.' *■ 
I CAN'T WAIT 
TO 6ET STARTED 
, IN SCRATCH/ 


Scratch Coding 


‘•g^atch 

Scratchisavisualptog^^wol 

which features * ^ ena bles you 

drag-and-drop i com p U ter games, ur-r-\ 

to create your ow and * nima tions using 

^mepr'ogtarnmingtechniques wit ou 

feature y wiUhelp 9 et you started with the 
basics of Scratch. 


th® Basics 


4 Tick off each 4 
step as you go! 


What you will learn 


By following the steps in this 
feature, you will learn... 


- will need 


This tutorial requires Scratch 2. 


• What all the buttons and toolbars in the 
Scratch window do 

• How to use blocks to make the Scratch 
cat move about 

• How to change sprites 

• How to create your own sprites 


To use it you need a Raspberry 

! Ini the latest version of 


Pi 2 or 3 running u.« plus a 
the Raspbian operating y mnuse ^ 


tandard USB keyboard and mouse 


The Raspberry Pi Annual 2018 








Stage 
2 backdrops 


degrees 


directioi 


Learn the 


You'll find Scratch 2 in Menu > Programming. Once 
opened, you will see a window like this... 


File ▼ Edit ▼ 


Scratch 2 

a •*- Ji © 


Scripts Costumes Sounds 




l"j project 




| Events 
| Control 
| Sensing 
| Operators 
| More Blocks 


| Looks 
| Sound 
| Pen 
I Data 


y* 


when 


1,'^H io l-.Ji bj 


point in dire 


forever 


point towards mouse-po 


90" 


go to mouse-pointer 


secs to x: 6>y: 


1. Stage 2. Blocks palette 

3. Scripts area 4. Sprite list 


t Done ^ 


Mato the Scratch cat move 


white background is an example of a sprite in Scratch, 
wnne oac u b | ank stage F|rs , , et . s get t h e 


The cat on the 
Currently the Scratch cat sprite is on a 

cat to move. 


1. Click on the Scratch cat sprite. 

2. Then click on the blocks palette and select Events. 
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Scratch Coding 


3. Next, drag a when green flag clicked block and place it on the 
scripts area on the right of the screen. 

4 Add a blue move 10 steps block from the Motion blocks palette and 
connect it to the when green flag clicked block. 

5. Now click the green flag icon at the top rig ht of the stage and see 
the cat move! 

6. How would you get the Scratch 
move further? 




when 


clicked 


move mlj steps 


Changing the way the sprite looks 


All sprites in Scratch can wear different costumes. 

1. Click on your sprite to select it. In the Scripts area in the middle of 
the screen, click on the Costumes tab. 

2. You will see that the cat has two costumes. Right-click costume 2 
and select duplicate to make a third costume. 

3 ‘ . S l eCt n C rr e3 and il wiM appear in the Paint Editor. Experiment 
with all the buttons and tools to find out what they do. H 

4. Next, draw some clothes on the costume and click OK. 

5 ' Il!!r, Ch costumes ’ click the Scripts tag. Add the 

purple Looks block, switch to costume, to the other blocks and 
connect it. 


6. Select costume3 from the 
drop-down menu on the 
purple block. 

7. Now run your program to see 
the costume change. 
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Learn the Basics 


Add sprites 


If you feel that the Scratch cat sprite does not suit your needs then you 

can add other sprites, or even create your own! 

1. At the top of the Sprites palette are four icons to create a new sprite. 

2. The first allows you to Choose sprite from library. This opens a 
window where you can choose one of Scratch's built-in sprites. 

3. The second icon, Paint new sprite, opens the Paint Editor. Here you 
can use shapes, lines, and freehand drawings to make your own 
custom characters. Have fun! 

4. The third icon lets you Upload sprite from file, to use an existing 
image or Scratch sprite. 

5. The fourth icon enables you 
to create a New sprite from 
camera (if one is connected). 


Sprites 


New sprite: ❖ / 4) 


■ Done A 


SCRATCH IS 
A SR6AT 
INTRODUCTION 
TO CODINS.' 


Now you know the bssics of 
Scratch, there are lots of great 
projects you can have a go at... 

Try completing the Robot Antenna 
Resource to make an LED blink! 

• Create a button using candy sweets 
with the Sweet Shop Reaction Game. 

These and more can be found on the 
Raspberry Pi Learning Resources 
website at... 

www.raspberrypi.org 
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Scratch Coding 


<T 


ukot vaii will learn 


By completing this project 


The version of Scratch included with the 
Raspberry Pi has a number of unique 
features; one of the most useful is its 
ability to communicate with the GPIO pins 
(General Purpose Input Output). These pins 
allow you to connect your Raspberry Pi to 
a range of devices, from lights and motors 
to buttons and sensors. The original 
Raspberry Pi had a 26-pin header and 
newer models (B+, Pi 2, Pi 3) have a 40-pin 
header, but this project will work with 
any model. 



you will learn... 

How to control the GPIO pins 
using Scratch 

How to receive input from the 
GPIO pins using Scratch 
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I 2 A+B^p(o 

'3® • 5 V 
’2® • 5V 
3* • GND 
4« • Qp-j^ 

3® •GP1 C 
7««GP16 
7**GND 
>• • GP23 
!• • GP24 
* • GND 
• • GP25 
• *GP8 
• • GP7 
* • 10 sc 
* • GND 
* *GP12 
“no* ®GND 
GP19® ®GP16 
GP26® « GP2C 


* t *//M.*.io/po f t I p, u( 

PI USB ports dtk' 
®t this ond W 


Physical Computing 


GPIO pins 


^^Tick off each 
^ step as you go! 


com iNe Me 

WITH SCRATCH 
AND we CAN DO 
CeeAT THINC-S 
Toc-et nee/ 


There are 40 pins on the Raspberry Pi (26 pins on 
early models), and they provide various different functions. 

used^o^Make^Ir^yoijrpirriabe^ts h , e ' P !? wha ‘ P'" is 
the USB ports, pointed onwards keyri " 9 hole faci " 


One powerful feature of the Raspberry Pi 
ls .7 e r ° w °f GPIO pins along the top edge 
of the board. GPIO stands for General- U 
Purpose Input/Output. These pins are a 
physical interface between the Raspberry F 
and the outside world. At the simplest level 
you can think of them as switches that you 
can turn on or off (input) or that the Pi can 
turn on or off (output). 


The GPIO pins allow 
the Raspberry Pi to 
control and monitor the 
outside world by being 
connected to electronic 
circuits. The Pi is able 
to control LEDs, turning 
them on or off, run 
motors, and many other 
things. It's also able to 
detect whether a switch 
has been pressed, the 
temperature, and light. 
We refer to this as 
physical computing. 
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Scratch Coding 


„ you don't have a pin label, then this guide can help you to identify the 
pin numbers... _ 




Raspberry Pi A+ / B+ and Raspberry Pi 2/3 pin numbers 
6PI0 ^ Ground (^) 3.3v (Q) 5v (^) 


ID EEPROM 

Advanced use only 


labelled as 3V3, 5V, GND and GP2, GP3, etc... 
3.3 volts 


ID_SC/1D_SD/DNC 


Special 
purpose pins 


Anything connected to these pins 
'A/ill alwa ys get 3.3 V of power 

Anything connected to these pins 
will always get 5 V of power 

Zero volts, used to complete a 
circuit 

These pins are for general-purpose 
use and can be configured as input 
or output pins 

Don't use these ones 


M You must 
M be careful 
W with the pins ^ 
f on your Raspberry 
Pi or you can do it 

irrepairable damage. 



WARNING! 




If you follow the instructions, then playing 
about with the GPIO pins is safe and fun. 
Randomly plugging wires and power sources 
into your Pi, however, may destroy it, especially 
if using the 5V pins. Bad things can also 
happen if you try to connect things to your Pi 
that use a lot of power; LEDs are fine, motors 
are not. If you're worried about this, then you 
might want to consider using an add-on board 
such as the Explorer HAT until you're confident 
enough to use the GPIO directly. 
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Physical Computing 


M 


Lighting an LED 


7 ‘ IS:? ,0 the GND pin ' and the 3V3 P in via *he 

2. Be sure to 
connect your 
LED the correct 
way round; 
the longer 
leg should be 

connected to IEHEBI 
the 3V3 pin... 


Done 


III! 



Using a switchable pin 


1. To control the 
LED, you'll need 
to adapt your 




























Scratch Coding 



‘ Constructing a 
Scratch program 


1. Locate the Scratch program by 
clicking on Menu followed by 
Programming, and selecting 

Scratch 2. 


■ «oi 


2. The familiar 
Scratch 
interface will 
then load... 


Click on 
Events 
from the 
blocks 
palette. 
Drag the 




when green flag clicked block 
onto the scripts area... 


when 


clicked 


4. To add GPIO functionality, first 
click More Blocks and then Add 
an Extension. You should then 
select the Pi GPIO extension 
option and click OK. 


Extension Library 


All 

Hardwa 


** 22 \ 
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5. In the More Blocks section, 
you'll now see two additional 
blocks for controlling and 
responding to your Pi GPIO 
pins. You can change the pin 
number by selecting the round 
field and typing it in. 


Make a Block 
Add an Extension 

Pi GPIO ▼ 


6. With set gpio 17 to output 
high or low, you can turn on 
your LED attached to GPIO 
pin 17 on or off. Using two of 
these inside a forever block, 
with wait blocks to add a 
delay, you can make the LED 
flash continuously... 


when clicked 


^ Done # 























Physical Computing 


Connecting a button 



3V3 SV 


1. As well as controlling the physical 
input device such as a button. 

2. Connect your 
button to a 
breadboard, then 
connect one pin 
to a ground pin 
and the other 
to a numbered 
GPIO pin. In this 
example pin 2 has 
been used- 


world, you can react to it using an 









Configuring your button 


da 


1. Before Scratch can react 
to your button, it needs 
to be told which GPIO pin 
is configured as an input 
pin. 

2. If you have added the Pi 
GPIO extension (step 4, 
page 22), clicking 
More Blocks will show a 
couple of blocks related 
to the Pi's GPIO pins. 

Make a Block 
Add an Extension 

Pi GPIO ▼ 


set gpio # to °utP ut 


3. In a new Scratch project 
file (File > New), select 
Events from the blocks 
palette and add a when 
green flag clicked to the 
scripts area. 

4. Select More Blocks, then 
drag a set gpio to block 
under the green flag one. 


when clicked 

set gpio A to output high 
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Scratch Coding 


5. Alter the block's number 
field to 2 - to set it to 
GPIO 2 for your button 
- and use its drop-down 
menu to set it to an input. 


when clicked 

set gpio Q to output high 

output high 
output low 


6. Clicking the green flag 
will now set GPIO pin 2 
to an input, so we will be 
able to sense whether the 
button is being pressed. 

7. Pressing the button right 
now won't do anything, 
but we can create a 
fairly simple program to 
respond to a button press 
to trigger something... 


Done 


1. Now that your button is all set up 
and working, you can make it do 
something. You can start off by 
making it control a sprite. 

2. Begin with a forever loop with an 
if else block inside it. This will 
continually check the if condition 
and perform some action if the 
condition is met or not. In this case 
showing one of two messages. 


when clicked 

set gpio Q to in P ut 


forever 


Now you need to add the condition, 
which requires a gpio 2 is high? 
block to be placed in the if else 
block's field. Note that as the pin is 
set high by default, and the button 
pulls it low, we put the say Hello 
block under else. 


'•V* 
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If everything is correct, your button 
should make the sprite say 'Hello'. 








These 

found 


• Using an active buzzer 

• Making traffic lights 

• Using a PIR sensor 


nd more can be 
i the Raspberry 
ling 

;es website 

cnherrvDi.orq 


Physical Computing 


Controlling a n LED with 
a button push 


To finish off, you can combine your two programs so that the button can 
turn the LED on and off. 


1. Adapt your script by replacing the say blocks in the if else block with 
set gpio 17 to output low and high... 


2. Now when you push 
the button, the LED 
should light up. 


clicked 


when 


set gpio auto output low 


set gpio ® to input 


forever 


if gpio 0 is high? then 

set gpiotfQto output low 


^ Done # 


□ 


else 


output high 


gpio 




There are lots of other things you 
can control or monitor with your 
Raspberry Pi. Have a look at the 
worksheets on the website to see 
how easily this can be done... 


The Raspberry Pi Annual 2018 














No more propping 
your eyes open with 

matchsticksto'try o» 

“ Kh rs^»^ 

^reddewetOTtosrt^ 

Off an alann When Santa 
sneaks into youi room. 

I?s a great introduction 

m using simple sensors 

the Raspberry Pt, and 
can be adapted to lots o 

different projects. 


Scratch Project 


S netector 



r w ■ 

X 

[ 

HOW OAQe 
)U THINK yc 

:ould evec 

)U 


CATCH Me.' 

A 


As well as a Raspberry Pi with an 
SD card and the usual peripherals 
you will also need... 


Hardware 

• 1 x passive infra-red sensor 

• 3 x female-to-female jumper leads 

Software 

• Up-to-date SD card image 

• Scratch 1.4 


* fh 


- * 


££> Mhatvou willlear " 


By creating a Santa detector with 
your Raspberry Pi you will learn... 


• How to connect a passive infrared 
(PIR) sensor to the Raspberry Pi 

• How to control the flow of your 

Scratch program by responding to the 
input from the sensor 
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Santa Detector 




Connect the PIR motio n senso r 


Before booting, connect the PIR module to the Raspberry Pi. 


Using three female-to-female jumper cables, you will need to 
connect each of the PIR sensor's connectors to the appropriate 
pins on the Raspberry Pi. 


Connect the top one labelled on the PIR sensor to the 
pin on the Raspberry Pi, connect the middle one labelled OUT to 
the GPIO 4 pin, and connect the bottom one labelled GND to a 
ground pin also marked GND. All shown in the following diagram. 


THIS 

WAY 

UP 


I ESI I 


Because we are using the GPIO pins, we 
need to start the GPIO server in Scratch., 


• On the desktop run Scratch using... 
Menu > Programming > Scratch 


Once Scratch is running choose... 
Start GPIO Server from the Edit menu. 


File pflSI Share 

, -* Undelete 


Help 


^ Start Single Stepping 
© Set Single Stepping 
O Compress Sounds... ^—. 
compress images... b 
Show Motor Blocks 
Start GPIO server 


#1 , 

b Done 


Scratch uses the Sensing blocks to 
check if there is any input on the 
GPIO pins. If there is an input, the 
value of the pin changes from 0 
to 1 . As you connected the PIR 
sensor to the GPIO 4 pin of the Pi, 
we need to monitor that. 


Firstly we need to tell Scratch that 
GPIO 4 will be used as an input by 
configuring it. 


Create a broadcast message 
as follows... 


broadcast config4in 
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slider 
light 
sound 
' resistance- 
resistance* 
resistance- 
I resistance 

tilt 

i distance 


Done 


tssss u —— 

nick on the Sounds tab ar 

Sssks: 


Done 


nrite 


Program ww* 


9P '° 4 sensor value 

show 

set size to £££) % 
wait secs 
Play sound Whoop 
set size to fflR) <* 


Scratch Project 


If you do 


not see gpio4 


Double-click the broadcast block to run 
it. You only need to do this once. 

In the Sensing block palette, click on 
the drop-down menu on the sensor 
value block and choose gpio4. 

i Tick the checkbox to the left of the 
block to display the pin value on screen. 


on the list, make sure that 


the GPIO server is 

a"d that you have 

config broadcast. 


running 


Test the PIR sensor by waving your 
hand in front of it. When it detects 
movement, the value on the screen 
should change from 0 to 1. 

If *he va ,ue doesn’t change, check 
that the correct pins are connected. 


when Efflclicked 


forevc 
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Santa Detector 




santadetector 


What next?, 


New sprite: 


The if statement continuously checks the GPIO 4 pin sensor value. 
When this changes to 1. it does the following... 


Shows the sprite 
Makes the sprite bigger 
Waits a bit 

► Plays a sound 

> Makes the sprite normal size 


It keeps doing this as long as 
the sensor value is 1, i.e. when 
the PIR detects movement. 


The else statement simply 
hides the sprite when the 
sensor value is 0. 


Set up the detector 
in your, bedroom! 


> On Christmas Eve, set up your Pi 
with the sensor pointing at your 
bedroom door 

► Connect your Pi to a huge speaker 

Make sure the sensor does not 
detect you in bed or you will get 
false positives: the alarm will go off 
every time you move! 

Go to sleep 

Wake up when Santa comes in and 
feed him mince pies and sherry! 

H5one 


Other stuff you could try to take 
your project to the next level... 

ft Make the background flash 
Animate the sprite using costumes 

• Change the sound ('Santa Claus Is 
Coming to Town' would be good!) 

• Use different graphic effects instead 
of change size 

• Display a message 

• Build a support or stand for the PIR 
module to sit on 
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How quickly did you 
manage to solve the 
puzzle? Write in your 
time below... 


iThe Raspberry, Ri Annual 20,18 

































































Find all the words in th 


Timed Ch3llenc|e 


There are 17 words in this giant 
Raspberry. You have 10 minutes to find 

them all. Go! 

Minecraft 
Network 
Program 
Python 


Algorithm 

AstroPi 

Computing 

Gaming 

GPIO 

Memory 


Scratch 
SD Card 
Sensors 
USB 


Raspberry Pi WiFi 
Robot 


er °spbt 


rryg 
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How quickly did you 

manage to solve the 
Puzzle? Write in your 

t/me below... 
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program 


Mtaecfaitis Available for the 
This means you can wine 

ssss^rsr 

4 k ; ks ?5 


UH^the gam® on the PH 


By following this project with your Raspberry Pi 
you will learn... y ' 

• How to access Minecraft Pi and create a new world 

IdTf tn USe t * 16 P ^ t * 10n Programming environment 
IDLE to connect to Minecraft Pi 

• How to use the Minecraft Python API to post text 
to the chat window, find the player's coordinates 
teleport and build structures 

• 5 SST variablcs ,0 store IDs for different 11,1,63 

Experimenting with placing different types of blocks 
With SDec a attrihnt** diocks 


you CAN 
CONTROL 
MINPCPAPT PPOM 

yout? p\! 




Whatvou 


„ r-sssSiS- 


Tick off each 
step as you go! 


























To run Minecraft Pi, open it from the 
desktop menu, in Games, or type 
minecraft-pi in the Terminal. 

When Minecraft Pi has loaded, 
click on Start Game, followed by 
Create new. You'll notice that the 
containing window is offset slightly. 
This means to drag the window 
around, you have to grab the title 
bar behind the Minecraft window. 


0 Programming 
Office 
^ Internet 

B 

I Accessones 
y Graphics 
f|} Sound & Video 
m System Tools 

| ^ Help 

f=1 Preferences 
I^Run... 

o Shutdown... 


|pi(2)raspberrypi: 


Python Games 


Fun with Blocks 


You are now in a game of 
Minecraft! Go walk around, 
hack things and build things! 


use ths Mouse to look: - 

APOUND A NO use THe FOLLOWING 

Keys on THe iceyeoAPQ* 

You can select an item from the quick draw panel 
with the mouse scroll wheel (or use the numbers on 
your keyboard), or press E and select something from 
the inventory. 


Key Action 

w Forward 


Backward 


E Inventory 

space Jump 
Double 

space Fly/Fall 


ESC 


TAB 


Pause/ 

Game menu 

Release mouse 
cursor 
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The Raspberry Pi A, 


You can also double-tap 
the SPACE bar to fly into 
the air. You’ll stop flying 
when you release the 
SPACE bar, and if you 
double-tap it again you II 
fall back to the ground. 


With the sword in your 
hand, you can click on 
blocks in front of you 
to remove them (or to 
dig). With a block in your 
hand, you can use right 
click to place that block 
in front of you, or left 
click to remove a block. 

Done 


With Minecraft running, and the world 
created, bring your focus away from the 
game by pressing the TAB key, which will 
free your mouse. Open Python 3 (IDLE) 
from the Programming menu and move the 
windows so they are side-by-side. 

You can either type commands directly into 
the Python window or create a file so you can 
save your code and run it again another time. 

If you want create a file, go to File > New 
window and File > Save. You'll probably 
want to save this in your home folder or a 
new project folder. 

Start by importing the Minecraft library, 
creating a connection to the game and 
testing it by posting the message "Hello 
world" to the screen... 

from mepi.minecraft import Minecraft 
me = Minecraft.create() 
mc.postToChat("Hello world") 

If you're entering commands directly into 
the Python window, just hit ENTER after 
each line. If it's a file, save with CTRL+S 
and run with F5. When your code runs, you 
should see your message on screen inside 
the Minecraft game. 


'■ 9 $ O r* ‘Python34 2Sh*H* """Mn»craft• Pi«&tion 


| E* £■* Q*bw 9 fetwn tfmdmn 

■ 0<i 1* mm. fi:ii: m} 

J| l«£ 4.*.>1 on Itnu. 

II Jjt*. * < **> r, <**** > or >• for mott inforajtMtn. 






























Coding with Hmecraf t 


*■ Done 


1. Find your location 

To find your location, type... 

pos = me. player. getPosQ 

pos now contains your location; access each part of the set of coordinates 
with pos.x, pos.y and pos.z. 

Alternatively, a nice way to get the coordinates into separate variables is to 
use Python's unpacking technique... 

x, y, z = me.player.getPos() 

arethewalldng direction's (forward^ V is up/down ' 


2. Teleport 

As well as finding out your current 
location, you can specify a 
particular location to teleport to. 

y, z = mc.player.getPos() 
me. player. setPos(Xj y+ , z) 

This will transport your player to 
100 spaces in the air. This will 
mean you'll teleport to the middle 
of the sky and fall straight back 
down to where you started. 

Try teleporting to somewhere else! 


Done 

»Q. 


?; u S c*n Placed single block at a 
given set of coordinates with 

mc.setBlock() ■■■ 

— ^^g.player.getPosO 
mc.setBlock(x+ , )/> z > ' 

Now a Stone block shou'dappear 
, -i lAfhprfi vou F rG standing. 

rxissssstf" 

ssszicsxr 


1 


+ 

























The arguments passed to se^Blockarex y, z : block aW ay 

block we’d like to place. 1 is Stone. 

Other blocks you can try... 


Now with the block in sight try 
changing it to something else... 

mc.setBlock(x+ , ) 

You should see the grey Stone 
block change in front of your eyes. 


4. Block constants 

You can use built-in block constants to set 
your blocks, if you know their names. You'll 
need another import line first, though. 

from mcpi import block 

Now you can write the following to place 
a block... 


5 Block as variable 

rtyou know the ID of a block. 

/can be useful to set rt as 

a variable. You can use the 

name or the integer ID. 


mc.setBlock(x+ , y, Zj block.STONE.id) 1 dirt ", . , v v z , dirt) 

I mc.setBlock(,x, y> 


Block IDs are pretty easy to guess, 
just use ALL CAPS, but here are a few 
examples to get you used to the way they 
are named... 


or 


dirt = block.DIRT.id 
mc.setBlock(x, y, z - dir > 


WOOD_PLANKS 

WATER_STATIONARY 

GOLD_ORE 

GOLD_BLOCK 

DIAMOND_BLOCK 

NETHER REACTOR CORE 


% Pone #■ 


Done 















Coding with Minecraft 




Here the fourth parameter 1 sets the Wool colour to orange. Without the 

fourth parameter it is set to the default (0) which is white. Some other 
colours are... 


2: Magenta 
3: Light Blue 
4: Yellow 


Try some more numbers and watch the block change colour! 

Other blocks that have extra properties are wood (17): oak, spruce, birch 

etc tall grass (31): shrub, grass, fern; torch (50): pointing east, west 
north, south; and more. 


7. Set multiple blocks 

As well as setting a single block with set.Block , you can 
fill in a volume of space in one go with set.Blocks ... 

stone = 

|x, y, z = me.player.getPos() ^_ 

mc.setBlocks(x+ , y+ , z+ , x+ , y+ , z+ ^ stone) 

This will fill in a 10 x 10 x 10 cube of solid Stone. 


You can use 
the set.Blocks 

function to create 
bigger volumes, but 
it may take longer 
to generate! 




6 . Special blocks 

There are some blocks that have extra properties, such as Wool which 
has an extra setting where you can specify the colour. To set this use the 
optional fourth parameter in set.Block... 

wool = 

mc.setBlock(Xj y_, z> wool, ) 









































































Another interesting block is TNT! To place a normal TNT block, use 


mc.setBlock(x, y, z y tnt) 


However, this TNT block is fairly 
boring. Try applying data as 1 


mc.setBlock(x, y, z, tnt 


Now use your Sword and left w 
click the TNT block: it will be 
activated and will explode in a 
matter of seconds! 

Try making a big cube of TNT blocks! 


mc.setBlocks(x+ , y+ , z+ , x+ , y+ , z+ll y 


Now you'll see a big cube 
full of TNT blocks. Go and 
activate one of the blocks 
and then run away to watch 
the show! It'll be really 
slow to render the graphics 
as so many things are 
changing at once. 


Done ^ 


TUT TNT THl TUT,-iW WIJyMMirilflJB 
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• i, m 

9 tt 



■ M 


i- 


I-*:vftj L '"A\ 



/ 

r 


;> «•» 1 















































r you CAN 
ADJUST THE SLEEP 
PAPAMETEPS TO 
ALLOW MOPE OP 
v LESS LAVA v 
\ TO 


^ Done 


Coding with Hinecraft 


One block that's a lot of fun to play with is 
flowing Lava. 

from mcpi.minecraft import Minecraft 
me = Minecraft.create() 
x .» y> z = me.player.getPos() 
lava = 

mc.setBlock(x+ , y+ , z, lava) 

Find the block you've just placed, and you 
should see Lava flowing from the block to 
the ground. 

The cool thing about Lava is that when 
it cools down it becomes rock. Move to 
another location in your world and try this... 

from mcpi.minecraft import Minecraft 
from time import sleep 

me = Minecraft.create() 

x .> y> z = mc.player.getPos() 

lava = 
water = 
air = 


mc.setBlock(x+ , y+ , lava) 
sleep( ) 

mc.setBlock(x+ ,y+ , z, water) 
sleep( ) 

mc.setBlock(x+ , y+ , z, air) 


There's plenty you can do now you 
know your way around the Minecraft 
world and how to use the Python interface. 

• Networked game 

If multiple people connect Rasp ^^ 
to a local network, they can join the same 
Minecraft world and play together Players 
an see each other in the Minecraft world. 

• API reference 

For a more extensive documentation ot 
functions and a full list of block IDs, visit 

bit.ly/MinecraftAPI 

Try^anothTr 6 resource and make a Whac 
a-mole game: Minecraft Whac-a-Block. 

Find links to these projects and more at... 

www.raspberrypi.org 

















Did you know there are two Raspberry 
Pis on the International Space Station? 
Learn more at astro-pi.org! 
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There are 12 differences ' 3et 'J v ® en Denmark ain 


W There are 12 opwatc h, then mark all the 

dSnSoSo" picture 2 and write in your time. And then,« 
time to iumph/page 78 to see if you g* * _ 









IN SPACE 
NO-ONE CAN 
HEAP you 
SCPEAM "PI.'" 
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How quickly did you 
manage to solve the 
puzzle? Write in your 
time below... 


Qd> 


rrefTTm 







Babbage versus bugs 




o«r« 


xc iiing space 


Invaders clone! 


Go to goo.gl/PyzcFA, press the green 'Clone or download' 
link on the right and select 'Download ZIP 





Double-click on the downloaded zip hie in' ^"now 
_ folder and click the 'Extract files icon, then Extr 

V click through to the bugs folder to find the pro,ec . 




Hioht-click on bugs.py and open with Thonny or a text editor. 
You'll find the following code listing. Check out the code, then 
go to the end of the proiec, (page 45) see how toplayd! 


It's much 
more rewarding 
to write the code 
yourself! Press the 
menu button, go 
to Programming 
and select Thonny. 
Open a new file and 
write out the code 
as you see it here. 
When you're done 
save it in the 'bugs' 
project folder you 
downloaded with 
'■py' at the end of 
the file name. 





Babbage versus bugs 


class Bug(Acton): 

def_init_(s, pos, kind): 

supen()._init_("blank", pos) 

s.kind = kind 
s.life = kind* 
s.time = 8 

def update(s): 

s.time -= 

s.x += P[state.pc ][ ] 
s.y += P[state.pc ][ ] 

c = s.collidelist(state.beams[ ]) 
if c >= : 

state.beams[ ][c].h = 


s.life -= 
if s.life == : 

state.score += s.kind* 

s.time = 



if rand( , ) == : 

state.beams[ ].append(Beam(s.pos, )) 

s.image="bug"+("s" if s.time> else str(s.kind))+str(state.pc » & ) 

class Star(Actor): 

def_init_(s): 

super()._init_("star", (rand( , W- ), rand( , H- ))) 

s.v = rand( , ) 

def update(s): 

s.y -= s.v 


if s.y < : 

s.x = rand( , W- ) 
s.y += H 

class Beam(Actor): 

def_init_(s, pos, v): 

super()._init_("beam", pos) 

s.v = v 
s.h = 0 

def update(s): 

s.y += s.v 

class Player(Actor): 


© .© © e © eg 

© © © © <■ Q jg 
© © © © , © & 


'UUV 
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Babbage versus'bugs' 


superQ._init_("blank", (W/ , H- )) 


s.time = 
s.time = 
s.life = 

def update(s): 

s.time -= 
s.time -= 


TO Update me 


The update method ls 

where we check for button 


presses to.... 
an d right, and 


move Babbage 
collisions 


left 


if he's been hit by a bug 


to see 


pc » & )) 


dx = ( if keyboard.right else )-( if keyboard.left else ) 

s.x = max( , min(W- , s.x+dx)) 

c = s.collidelist(state.beams[ ]) 
if c >= and s.time < : 

state.beams[ ][c].h = 

s.life -= 
s.time = 

if keyboard.space and s.time < : 

state.beams[ ].append(Beam(s.pos, - )) 
s.time = 

s.image = "bab"+("s" if s.life > and s.time > else str(state. 


class State: 

def_init_(s): 

s.bugs = [] 
s.beams = ([], []) 

s.stars = [StarQ for s in range( )] 


s.player = Player() 

s.score = 
s.space = 

s.wave = 


Classy 

The class State sets 
up our game, initialising 
things like bugs, our player, 

and the scoreboard. 


def update(s): 

if len(s.bugs) == : 

for y in range( ): 

for x in range( ): 

s.bugs.append(Bug((W/ +x* - , y*c 0-1 ), if 

F[min(s.wave, )](x, y) else )) 

s.pc = 

S.pc = 0 
s.wave += 


for a in s.all(): 
a.update() 
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Babbage versus bugs 


s.bugs = [b for b in s.bugs if b.life > ] 

s beams = ([b for b in s.beams[ ] if b.y > - and not b.h], 
s.beams U ^ ^ in s>beams[ ] if b . y < H+ and not b.h]) 

s.pcl += 1 

if s.pc == P[s.pc ][ ]: 

s.pc = if s.pc == else s.pc + 

s.pc = 

d8f ^return s.stars + s,bea».s[ ] + s.bea»s[ ] + s.bugs + [s.player] 

def Taturn s.player.life <= or len(s.bugs) and max([b.y for b in s.bugs]) 

> s.player.y - 

state = State() 

def update(): 

global state 

if state.over(): 

if keyboard.space and not state.space, 
state = State() 

else: 

state.update() 

state.space = keyboard.space 

def draw(): 

screen.clear() 

for a in state.all(): 
a.draw() 

for i in range(state.player.life): 

screen.blit("life", ( +i* , H- )) 

screen.draw.text(str(state.score). bottomright=(W- , H- ), fontname="consola", 

fontsize= ) 

if state.over(): 

screen*.draw^.text("GAME OVER", center=(W/ , H/ ), fontname="consola , 

fontsize= ) 


_ c re«*» ts: 
Ga*» eC 

jgggf 


Run .the game 


Press the menu button, select Accessories, and then Terming 

Type* cd Downloads/Annual-2018-master/bugs. NowW 

pgzrun bugs. py (or the name you gave your own file), no 
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Activity 





What are your Christmas 
plans for your Raspberry Pi? 

A. Build a Santa detector 

B. Teach it to fire darts at your sister 

C. Leave it on the floor in the dark so 
Dad steps on it in bare feet 


I Which of these is the best 
Raspberry Pi project? 


A. Hamster disco 

B. Parent detector 

C. WhooPi Cushion 


What would make your 
1 Raspberry Pi even better? 

A. An elegant moustache 

B. Terrifying bat wings 

C. A laser turret 


< 


A 


| Your Raspberry Pi broke. 

I How did it happen? 

& plummeted out of a tree 

B. Dropped into a school dinn 
c. Fell in the toilet 


, You have a terrible 
A. Killer robots 

C. Healthy earing program, with 

lots Of vegetables 
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A. In the fruit bowl 

B. In your stinky gym kit 

r. In Mum's underwear drawer 


Personality Test 


The, Raspberry, RrAnnual •2018 


What do you 
think is the 
best name for a 
Raspberry Pi robot? 

A. Affonse 

B. Mr Fluffypants 

C. Murderborg 


What robot would 
you most like to 
build with your Pi? 

A. Robo-shark. With lasers. 

B. Robo-dog 

C. Robo-butler 


Each answer you give earns 
you points! Answer A = 1 point, 
B = 2 points and C = 3 points. Flip 
the book over and find out how you 
scored at the bottom of the page! 


. 'Auunj si jous >|unn 

noA Aiqoneu \\q e sauigaiuos pue 'A>pn| Ajoa a^noA :pZ~6l 

joqoj e umo oj a>ji| p,noA ajiduieA 
e aq A|qeqojd p,noA ‘jaisuoui Aue aq pinoo'noA j| :oi-fci 
A|juie^ jnoA qj.jM siuasajd 6ujuado si seiuisijun 10 
Jjed apjnoAej. jnoA \ie*s seuqsuqo 6uua'u!|6 e a'je noA :£ 


iaAeq noA Ameuosjad y Ajjaqdsesj 
pup l lei * M mo pug - sjoop aqj uo sajoos aqj aje ajan 







find the hidden phrase 


d and ro 


ies a special 
i decipher the 
;rack it! The 


W This is the Wheel c 

W phrase', skip every 

code-you have just. 

pictures might help you 


saWV 


now quickly did 
manage to solve 
Puzzle? Write in \ 
time below... 
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With this sacred Pi, 
we can create a world of 
knowledge, peace, joy, and 
delicious code! 


HAHAHA 
HAHA! 


My friends; 

We have finally completed 
the PCS of destiny. 
Our mission can now begin! 


FOOLS! 

The only world you 

SHALL INHABIT IS A WORLD 
OF MISERY AND PAIN! 


MllHAHAHAHA! 
























































































































































































Holy GrlO! ' 
Doctor Dluescreen 
really ie uploading 
the children! 

































Hmmm, ' 
her shields are 
stronger than 
we thought. 


Ha ha! 

Your pathetic code 
bearns are no match 
for my mighty orb! 


We must merge our 
code into one beam 
of pure energy! 


. 


ttZAP 


Argh! 5till nothing! 
Her shields are 
resistant to our code! 













































WHAT THE HELL 
ARE WE GOING 


Thanks, 

I needed that. 


Pull yourself 
together, man! 


TO 00?! 


/ Now think, 
there must 
be something 
+ , we can do. 


Do you mean 
this old thing? J 


The computer 
could be anywhere 
in the world! 
how could we ever 
find it in time 
to save them?/ 


Well, legend 
has it that 
there is an 
ancient computer 
that can be used 
in times of dire 
need. But that's 
just some legend 
from mS! 
















































^ Excellent! 

Let's destroy 
those Raspberry 
fools and be on 
. our evil way. j 


Doctor, all the children 
are uploaded into 
the spreadsheet 
and saved to 
your desktop. ^ 1 


friends... 
grow week 


(mm 


^^ Ws a!ive\^ j 


If this is our end, 
let it be known that., 
we fought gallantly, 
even if...our efforts 
were futile. 


AT THE Mg | 





































































































Err...yeah, that 
too! 3ut the main 
lesson here is 
that... j 


That all life Is a precious 
and delicate gift that must 


And what have 
we learned from 
our little 
adventure? 


be nurtured and loved like a flower? 


(tASP&KKYP/ 

nous/ 


Y You have freed ^ 
me from my 
watery tomb—I can 
now return to 
my Mecha-family. 
That is thanks enough, 
my tiny friends, j 


BACK ON EARTH 


Well—we did it. 
The earth is safe 


once again 


































Python Project 


Make sure you don't call 

- thaXTh TUftle projects turtle.py 
that s the name of the Python 

library you're importing! 


^ Tick off each ^ 
step as you go! 

O' B 




:vy ,: 


spirals. You " ou w ill learn 
Turtle. Along the wa ^ J an a use 

how to think *” * sequence’. This is 
loops to repeat a offi a visU al 

a great stepping hke Scratch to 

CTex"d environment of Python. 


JIKMteJQl 

By making patterns with Python 
code, you will learn... 


• To take your first steps with the 
Python programming language 

• How to draw lines with Python Turtle 

• How to make turns 

• How to change the pen colour 

• How to use loops to repeat some 
instructions and create shapes 

• How to use more loops to create 
impressive spiral patterns 


; W i t h your Raspb paspb'ian!y U o P u have 

90 ‘ nSt vou need for this project^ 
everything you nee 


LtAPN HOW 
TO CONTROL Me 
U5INC- eASY 
PYTHON CODe.' 


I 




















Turtley Amazing 


Is it art, maths, or 
computer science 


Have a look at the image to the right. 
How would you describe it? Is is art, 
maths, or computer science? 

It's a computer-generated image, but 
making it requires an understanding 
of art, maths, and computer science. 
Let's see how you too can make 
images just like this. 


Drawing a line 


tHp imaae above is made up of lines and 

SSSHS: 

£jSSKss- 

Run it to see what happens. 

from turtle import Turtle, Screen 

turtle = Turtle() 
screen = ScreenQ 

turtle.forward( 30) 

1. click on Run to see the code working. 

2. Now try changing the " uf nber-n the 

line turtle .forward (100). C,,CK 

Run again and see what happens. 


1 


You can run Python code 

servrJru OV t SerUsingonline 
services like Trinket (trinket io^ 

pTy„ UpP ff onon ^“^ 

^thep^ nd,helatea ^ions 

e Programming menu. 





Python Project 


3.1 r* 

Turning 




You've used code to draw a line. Good work! Now let's try making 
the turtle turn around. To do this you need to instruct the turtle not 
only to move forward, but also to turn right or left. 

from turtle import Turtle, Screen 


turtle = Turtle() 
screen = ScreenQ 


) 


turtle.forward( 
turtle.right( 0) 
turtle.forward( ) 


1. What do you think will happen in the 

code above? Click on Run to see if you were right. 



turtle.right( ) turns the cursor 90 degrees right. You can also 
turn left with turtle.left( ). To change the amount that the 
cursor turns, simply change the value of degrees. 

2. Complete the square shape you've started by adding more lines 
of code and press Run. Keep trying until you get it right. 



Try to complete each of the 
challenges below... 

• Draw a rectangle: two of the four 

sides need to be longer 

• Draw a triangle: how many 
degrees do you need to turn? 

• Draw a cross: backward and 
forward work well together 

• Draw a circle: what happens if 
ii turn lots? 









A* changing colours | 


I 


The default colour for the pen used by 
the turtle cursor is black, and the default 
background colour is white. You can 
change the colours to make your shapes 
look even better. 

1. Look at the code below. It contains 
three variables called R, G, and B. 

from turtle import Turtle, Screen 

turtle = Turtle() 
screen = Screen() 
screen.colormode(255) 

R = 

G = 

B = 

screen.bgcolor((R, G, B)) 

Variables are a way of storing a value 
and giving it a name. For instance, there 
is a variable name R with a value of 

255. 

2. Run the code and see what happens. 

3. Try changing the values of the three 
variables, and see what happens. 
(Note: the maximum value is 255, 
and after this there will be no effect.) 
What do you think R, G, and B 
represent? You can change the value 
of your variables either by setting 
them to a new value, or by increasing 
and decreasing them. 


4. You can change the 
colour of the turtle as 
well. Run the code below 
to see what happens... 

from turtle import 
Turtle, Screen 


turtle = Turtle() 
screen = Screen() 
screen.colormode( 255 ) 

R = 

G = 

B = 

turtle.color((R_, G, B)) 
turtle.forward( ) 

turtle. right( ) 
turtle.forward( ) 



Challenge 

^*„r£r cho,,he 

■ssr eo,,our 
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Repetition 


fastest ways to g 1"teth°n^ Quite 

“lie out another set of instruchons. For 
example, the square you created1 ear 
ooc the same two instructions four 
times Rather than writing them out four 
times you could write them out once bu 

add instruction to repeat them. 

saifSI- 

then a while loop ought be best it yo 
want to loop for a set number of times, 
then a for loop is preferable. 


I- Here, we have used a while 

the* '? p : This means that 
the code inside the loop (i. e 

he code which is indented) 

will repeat forever. You 

can try to see what it does 

but remember it will loop ' 

around forever! 1 

Screen^^ 16 import 
turtle = Turtle() 
while True: 

turtle.forward( ) 
turtle.right( ) 

™V, ype 0f l0 °P is not going 
useful for drawing 

wamf r* h Tur,,e "here you 
want t0 be more precise. 7 



3 4 5 6 7 P 


2. In this example, 
a for loop 

has been used. 0 i 2 
Press Run to see 
what happens. 

from turtle 
import Turtle, 

Screen 

turtle = Turtle() 
screen = Screen() 

turtle.penup() 

for i in range( ): 
turtle.write( ) 
turtle.forward( ) 


Tlie'RaspberrviRi'Annual 2018 



A for loop repeats instructions 
a set number of times, in this 
case 8 times. A for loop has 

an associated variable (called 

i here). In this example, 1 
starts from 0 and increases by 
1 each time. Let's apply this to 
the code to draw a square... 

from turtle import 
Turtle, Screen 


turtle = Turtle() 
for i in range( ): 

turtle.forward( 

turtle, right ( 90 ) 
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Turtley Amazing 
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3. In the code in step 2, the turtle has 
been asked to repeat two instructions 
four times to make a square. 

4. Once you have created one shape 
using a loop, you can repeat the shape 
again and again by putting it inside 
another loop. This is a great way to 
draw spirals. Adapt your code by 
making it look like this... 

from turtle import Turtle, Screen 

turtle = Turtle() 

for i in range( ): 
for i in range( ): 

turtle.forward( ) 
turtle.right( ) 
turtle.right( ) 

A spiral can be made by turning a small 
degree and then moving forward a small 
amount. The section of code for making 
a square is inside another for loop that 
repeats it 30 times, each time turning the 
cursor 25 degrees to make a pleasing 
spiral shape. 


Challenge 

Try to complete each of the 
challenges below... 

• Can you alter the for loop so 
that it draws a more interesting 
spiral using one of the shapes 
you made earlier, like a triangle 
or circle? 

• Adding a few extra lines where 

you alter the variables R, G, 
and B would allow you to make 

a multicoloured spiral. Have a 
go at creating a rainbow spiral. 

• Draw a circle: what happens 
if you turn lots? 




Done 


Take your Raspberry Pi tricks to the 
next level with these ideas. 

Learn how to use functions to draw 
snowflakes using Turtle 
Create interactive stories using lists 
in Python with the Storytime resour 

found on the Raspberry P. website 

Take your first steps controlling physical 
objects with Python and a Raspberry 

• Become a Python turtle expert by 
continuing with the advanc 
of Turtley Amazing! 
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ppi Cushion 





whatever 



To build your very own farting 

machine you are going to nee ... 

O 2 paper P* ates 

• a washing-up sponge 

• Kitchen foil 

• Sticky tape 

* 2 f^Iie header wires (that fit on the 

A speaker (the louder the bett 


nee-Hee.' 

eveeyoNe will 

THINK 6PANDAP 
HAS FAQTeOf 


fcodel 

l^clubj 


Apart from learning which members 
of your family have a sense of 
humour, you will also learn... 

• Howto create Raspberry Pi sensors 
with household objects 

• How to code simple programs in 
Python to carry out tasks 

• How to use the Terminal 


-V 


^ Tick off each 
step as you go! 
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A. 


The WhoopPi Cushion 


Making the WhooPi Cushion 


1. Tape or stick squares of foil on the middle of the eating side of each 
plate. These are your contacts - when they touch, they'll make a circuit. 

2. Strip the end of one of the long wires and tape it to one of the squares of 
foil. Make sure it makes good contact with the foil. Do the same with the 
other wire and the other plate. 

3. Chop the sponge up into cube chunks and glue them around the foil on 
one of the plates - this will stop the foil squares touching each other until 
someone sits on the plate. It should look something like this... 


PLAT6 


'spome 


wipe 


V 




V 


7 


TApe 


POIL* 








J-h 


4. Put the two plates together so that foil squares 
are on the inside and facing each other, ape 
them together. 

5. You now have a 'cushion' made of two plates with 
two connecting wires coming out. Later we will 
connect these wires to the GPIO pins on your 
Raspberry Pi: one to a ground pin and the other 
to a pin that we will use to detect when the circuit 
is made. For this we will use the header wires. 
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6. Strip the ends of the 

connecting wires and attach 
each one to a female header 
lead. One way is to cut off one 
end of the header lead, strip it, 
twist it to the long connecting 
wire, and then insulate the join 
with tape - but do whatever 
works best for you. 


t Done ^ 


5TQIP 
BNO AN O 

JOIN IT TO LON6J 
CONN6CTIN6 

wiee 

It's now time to hook up the Pi to 
your finished WhooPi cushion! 


% 







Note that if you 
have an older 
Raspberry Pi 
model you'll only 
have 26 pins, but 
they have the 
same layout. 

1. Plug one 
header lead (it 
doesn't matter 
which) onto a 
ground (GND) 
pin on the Pi... 


GP3 

GND 

GP4 

ma 


GP17 1 GP1 8 


GP27 


GP22|GP2- 


3V3 


GP1 0| GND 


GP09IGP25 


The Raspberry Pi Annual 2018 





































The WhoopPi Cushion 


2. Plug the other wire into GP.0 pin 2... 




igp iiW m 

||GP^P ^ 1 

Jp You can ^ 
M damage 
^ your Raspberry 
Pi if you do not 
use the GPIO pins 
correctly. Stay away 
from the 5V pins! 


for the software^ We area 1 ** 6 ’ now 

use Python - are go,n 9 to 
not used it before just foil' f V °H V * 
instructions and yiou wiMpfc^ rt'up. 

need to open a t 1? • ^' s you W 'H 

clicking on the scrSite Te ° W by 
'con, three alona S ,i ke Term mal 
°n your desktop... menu ,con 

Menu 


Done 




1. Connect the speaker to the 
Raspberry Pi. 

2. Create a new folder called 
whoopee with the following 
command... 

mkdir whoopee 

3. Enter the folder with... 

cd whoopee 

We're going to need a sample 
sound file for this project, so we'l 
download one. 


4. Download the burp sample with the 
following command... 

wget http://rpf.io/bunp -o 
burp.wave 

This will download the sample into the 
whoopee folder and rename it to burp.wav 

5. Now test that you can play the sound 
file using omxplayer by typing... 

omxplayer burp.wav 

You should hear it from the speakers 
or headphones connected to your 
Raspberry Pi. 
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If you can't hear anything, make sure that 
your speakers are connected correctly. If 
this still doesn't work, you'll need to change 
your audio configuration. To switch audio to 
the headphone jack, return to the Terminal 
window and type the following command... 
amixer cset numid=3 1 

Then try running the omxplayer burp.wav 
command again. Once the sound is working, 
it's time to write the program itself. 


Done 


I 

I 


A 


the following command... 

sudo idle3 & 

Once IDLE3 has opened, click on 
2 ' New Window. This will open a blank fde. 

Click on File and Save As and name the 

file whoopee.py- 

o Tvoe in the following program precisely- 
3 ’ {pal special attention to indentat.on and 

lower-case/upper-case let ers.) 

import time 

import RPi.GPIO as GPIO 
import os 

GPIO.setmode(GPIO.BCM) 

GPIO.setupC ,GPIO.IN) 
while True: 

if GPIO.input( ) =- Faise ’ nll _ v ..x 
os.systemC'omxplayer burp.wav ) 

time.sleepC ) 


4. Save the file by clicking on 
File and Save. 

5. Run the program by 
clicking on Run and Run 
Module (shortcut: F5) 

6. Finally, test your program 
- check that the sample 
plays when the foil 
contacts are gently pushed 
together. If it's all working 
then it's ready to go! 

Done 
































































The WhoopPi Cushion 


Si 


Setting it up 




Carefully place your WhooPi 
Cushion where your victim will sit 
on it (obviously!), but not under a 
really heavy cushion where it will 
squash it straight away. 

i The tricky bit is setting up the 
Pi so that it can't be seen - 
remember, you'll need a plug 
socket unless you are using a 
battery for your Pi. 

> Hide it, run the program, and wait. 

i\m 

Done 



Hint 

Whistle tunelessly and 
look around at the ceiling. 
This will make you look 
innocent and attract 
potential victims. 




""Per their pillow h,n a Pl Cushi °" 
sample. Note: This ^f d , w " h ,he new 
Pecket money or w 0 m? f loss °< 

^ C ° ,dita "1 P« it on YouTube! a " y i,y0U 



Visit... , . . 

www.raspberrypi.org/resources/make/ 

for more ideas and for help on using 
buttons and input devices on the Pi. 
This is also the first place to go if you 
are stuck or something's not working. 
You can also ask questions and get 
help on our forums at... 

www.raspberrypi.org/forums 















the words! 



Onset 


nnthle 


- You’ve got just assoC iated with 

yourself! All of t^Sne,!. As you 

Js P be.ryPio'“™“^.'' ie ' ettere 


ENACT FIRM 
RENT MAIL 
TSK DOPE 
RAG ROMP 
DO BAKERY 
ERRS BOW 
SLEW RISE 
WOK TERN 
NOT HYP 
BRIAN SPA 
NIL UX 




















































Mixed up words in Pyt h 


° n codes 


[ How good is your Python - and your codebreaking? Here's a challenge to find out. There 
are 8 Python functions - each of them prints out a single word when run. Can you work out 
what all 8 words are, and what they have in common? If you get really stuck, you can use 
Python on your Pi to run them, but try to work it out without cheating first! 


def testl (): 

textl = "apple" 
print(textl) 

def test2 (): 

textl = "eniregnat 

text 2 = "" , _.. 

for x in range (len (textl)). 

text2 += textl[ * x - ] 

print(text2) 

def test3 (): 
textl = "oag" 
text 2 = "ren" 
text 3 = _ 

for x in range (len (textl)). 
text3 += textl[x] 
text3 += text2[ * x] 
print(text3) 

def test4 (): 

textl = "bceyabrlkr 
text 2 = "" 

for y in range (len (textl)): 
text 2 += textl[x] 

X += 

x %= len (textl) 
print(text2) 

def test5 (): 
listl = [ 

textl = "" I _ .... 

for x in range (len (listl)). 

textl += chr (listl[x]) 
print(textl) 


the pipst onp 

15 P6ALLY 6A5Y, 
TO 5£T YOU 
STAQTtO! 


def test6 (): 

textl = "dsulfrw" 
text2 = "" 

for x in range (len (textl)): 

text 2 += chr (ord (textllxl) - 
print(text 2 ) L J ' 

def test7 () : 

textl = "($+!$7,+" 
text 2 = "" 

for x in range (len (textl)): 

text2 += chr (ord (textlfxl) A ) 
print(text 2 ) L ' 

def test8 (): 
listl = [ 

textl = "" 

a = int (pow (len (listl). )) 
or x in range (l + ma x (listl) // a 
z = sum (listl) // a 
for y in range (a): 


if y + x * a in listl: 


z += 1 « ( a _ 
textl += chr (z) 
print(textl) 


- y) 
















Puzzle Answers 


Page 46 
Space Maze 

Here's where you should have gone. 


Page 40 

Spot the Difference - Space 

12 more tricky differences here... 


Page 50 
Wheel of Pi 

The phrase was: CODE MINECRAFT WITH PI 

Page 76 

Anagram Acrostic 

The answers were: Minecraft, Terminal, 
Desktop, Program, Keyboard, Browser, 
Wireless, Network, Python, Raspbian, Linux. 
The secret phrase was Raspberry Pi. 

Page 77 
Python Puzzle 

Answers: apple, tangerine, orange, blackberry, 
mango, apricot, mandarin, raspberry. 


Page 30 

Spot the Difference - Pi 

Did you manage to find the 12 differences in 
the board? 


Page 31 

Big Pi Wordsearch 

How fast did you managed to find the 17 
hidden words? 
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GET STARTED 

Set-up your Raspberry Pi & use it for the first time 

SOLVE PUZZLES 

Spot the difference, word searches, mazes & more! 

MAKE PROJECTS 

WhoopPi cushion, Santa detector & tree lights 

LEARN TO CODE 

Learn as you go with Scratch & Python projects 

HACK MINECRAFT 

Code with Minecraft on your Raspberry Pi 

WRITE A GAME 

Create your own version of Space Invaders! 
































